<HTML>
<HEAD>
<TITLE>Installation instructions for Spreadsheet::WriteExcel</TITLE>
<LINK REV="made" HREF="mailto:">
</HEAD>

<style type="text/css">   



   <!--
   
   pre  {
        font-family : courier new, sans-serif;
        font-size : 10pt;
        color : #0066cc;
   }

   CODE  {
        font-family : courier new, sans-serif;
        font-size : 10pt;
        color : #0066cc;
   }
   
         
   -->
</style>


<BODY>


<P>
<H1><A NAME="Spreadsheet_WriteExcel">Spreadsheet::WriteExcel</A></H1>
<P>
Installation instructions for <A
HREF="http://search.cpan.org/search?dist=Spreadsheet-WriteExcel">Spreadsheet::WriteExcel</A>


</P>
<P>
<HR>
<H1><A NAME="Requirements">Requirements</A></H1>
<P>
This module requires <CODE>Perl 5.005</CODE> (or later) and <CODE>Parse::RecDescent</CODE> and <CODE>File::Temp</CODE>:

<PRE>    
    <A HREF="http://search.cpan.org/search?dist=Parse-RecDescent">Parse::RecDescent</A>
    <A HREF="http://search.cpan.org/search?dist=File-Temp">File::Temp</A>
</PRE>
</P>
<P>
<HR>
<H1><A NAME="Installation">Installation</A></H1>
<P>
<HR>
<H2><A NAME="Method_1_standard_install_with_">Method 1, standard install with make</A></H2>
<P>
Download the zipped tar file from one of the following:

</P>
<P>
<PRE>
    <A HREF="http://search.cpan.org/search?dist=Spreadsheet-WriteExcel">http://search.cpan.org/search?dist=Spreadsheet-WriteExcel</A>
    <A HREF="http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154">http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154</A>
    <A HREF="ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/">ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/</A>
</PRE>
</P>
<P>
Untar and unzip the module as follows or use winzip:

</P>
<P>
<PRE>
    tar -zxvf Spreadsheet-WriteExcel-0.xx.tar.gz
</PRE>
</P>
<P>
Change to the directory that <CODE>tar</CODE> creates. The module can be installed using the standard Perl procedure:

</P>
<P>
<PRE>
    perl Makefile.PL
    make
    make test
    make install    # You may need to be root
    make clean      # optional
</PRE>
</P>
<P>
Windows users without a working <CODE>make</CODE> can get <CODE>nmake</CODE> from:

</P>
<P>
<PRE>
    <A HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe">ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe</A>
</PRE>
</P>
<P>
<HR>
<H2><A NAME="Method_2_CPAN_pm_install">Method 2, CPAN.pm install</A></H2>
<P>
If you have <CODE>CPAN.pm</CODE> configured you can install the module as follows:

</P>
<P>
<PRE>
    perl -MCPAN -e 'install &quot;Spreadsheet::WriteExcel&quot;'
</PRE>
</P>
<P>
<HR>
<H2><A NAME="Method_3_ActivePerl_ppm">Method 3, ActivePerl ppm</A></H2>
<P>
ActivePerl users can use PPM as follows. If you system has PPM2 and PPM3
you should use PPM2 for this task:

</P>
<P>
<PRE>
    C:\&gt; ppm
    PPM&gt; set repository tmp http://homepage.eircom.net/~jmcnamara/perl
    PPM&gt; install Spreadsheet-WriteExcel
    PPM&gt; quit
    C:\&gt;
</PRE>
</P>
<P>
If this fails try the following:

</P>
<P>
<PRE>
    PPM&gt;install http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd
</PRE>
</P>
<P>
If both of these fail you should ensure that ppm is working correctly. Try
to install the File::Slurp module as a test:

</P>
<P>
<PRE>
    C:\&gt; ppm
    PPM&gt; install File-Test
    PPM&gt; quit
    C:\&gt;
</PRE>
</P>
<P>
A failure here will indicate that your ppm isn't configured correctly or,
more likely, that you are behind a firewall. Have a look at the
<A HREF="http://aspn.activestate.com//ASPN/Reference/Products/ActivePerl-5.6/faq/ActivePerl-faq2.html#ppm_and_proxies">Using PPM</A> documentation that comes with ActivePerl to see how to
resolve these issues.

</P>
<P>
<HR>
<H2><A NAME="Method_4_ActivePerl_local_ppm">Method 4, ActivePerl local ppm</A></H2>
<P>
If the previous ppm methods fail you can try a local ppm install as
follows. Download the following two files (xx is the most recent version
number). Note, in order to prevent your browser from trying to display or
unzip these files you should use your browser's &quot;Save Target As&quot;
option:

</P>
<P>
<PRE>
    <A HREF="http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd">http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd</A>
    <A HREF="http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz">http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz</A>
</PRE>
</P>
<P>
Copy them to a suitable temp directory. There is no need to un-tar or unzip
the PPM file.

</P>
<P>
In the DOS shell change to the temp directory and run ppm:

</P>
<P>
<PRE>
     C:\&gt; cd c:\temp
     C:\Temp&gt; ppm
</PRE>
</P>
<P>
<PRE>
     PPM&gt; install Spreadsheet-WriteExcel.ppd
     Install package 'Spreadsheet-WriteExcel.ppd?' (y/N): y
     Retrieving package 'Spreadsheet-WriteExcel.ppd'...
     Writing C:\perl\site\lib\auto\Spreadsheet\WriteExcel\.packlist
     PPM&gt; quit
     Quit!
</PRE>
</P>
<P>
The module should now be installed. Note, you will also have to install
Parse::RecDescent and possibly File::Temp if it isn't already installed .

</P>
<P>
<HR>
<H1><A NAME="Updates">Updates</A></H1>
<P>
You can keep up to date with future release by registering as a user with
Freshmeat <A HREF="http://freshmeat.net/">http://freshmeat.net/</A> and
subscribing to
<CODE>Spreadsheet::WriteExcel</CODE> at the project page:

</P>
<P>
<PRE>
    <A HREF="http://freshmeat.net/projects/writeexcel/">http://freshmeat.net/projects/writeexcel/</A>
</PRE>
</P>
<P>
You will then receive mailed updates when a new version is released.

</P>
<P>
Alternatively you can keep an eye on <A
HREF="news://comp.lang.perl.announce">news://comp.lang.perl.announce</A>

</P>
<P>
<HR>
<H1><A NAME="Author">Author</A></H1>
<P>
John McNamara (<A HREF="mailto:jmcnamara@cpan.org">jmcnamara@cpan.org</A>)
</P>

</BODY>

</HTML>

